home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / BBS-Archive / Util / Workbench / x_trash.lha / X-Trash / X-Trash.doc < prev    next >
Text File  |  1995-02-22  |  13KB  |  322 lines
  1.  
  2.  
  3.  
  4.             ====================================
  5.  
  6.                     X-Trash v1.1
  7.  
  8.               The trashcan maintenance utility
  9.  
  10.                 © 1994 Rudy Chiarito
  11.  
  12.             ====================================
  13.  
  14.  
  15.  
  16. Contents
  17. ^^^^^^^^
  18.  
  19. 1. Introduction
  20.  
  21. 2. Usage
  22.  
  23. 3. Odds and ends
  24.  
  25. 4. Program history
  26.  
  27.  
  28. Remember...
  29. "Most people don't act stupid: it's the real thing!" - Alfred E. Neuman
  30.  
  31.  
  32.        * · * · * · * · * · * · * · * · * · * · * · * · * · *
  33.  
  34.  
  35. /* *\
  36. * 1 *   Introduction
  37. \* */  ^^^^^^^^^^^^^^
  38.  
  39.  
  40.  1.1. Preface
  41. ^^^^^^^^^^^^^^
  42.  
  43.   The programs and files in this distribution are FREEWARE. That is: they
  44. are copyright © Rudy Chiarito, but they may be freely distributed as long as
  45. no more than a nominal fee is charged to cover distribution costs. Moreover
  46. they can't be distributed separately or in a commercial package without
  47. written permission from the author. That's all.
  48.  
  49.  1.2. I'm Trash, X-Trash
  50. ^^^^^^^^^^^^^^^^^^^^^^^^^
  51.  
  52. NOTEZ BIEN: This mighty program was born thanks to an interesting article by
  53. one Digito, "Data e Trashcan", which appeared in the May 1994 issue of the
  54. italian "Amiga Magazine". A big thank you is due.
  55. This program could remind you a similar one... Erm, when I finished V1.0, I
  56. discovered that someone had had the same idea (I'm speaking of AppTrash).
  57. I WROTE MY PROGRAM BEFORE I GOT TO KNOW OF APPTRASH'S EXISTENCE. I also
  58. think mine is slightly better. See for yourself...
  59.  
  60.   How many Amigans actually use the notorious Trashcan? Is it any good? As
  61. to me, I could have been using it the first two-three times I toyed around
  62. with my old, luxuriant A500; i.e., a long long long time ago.
  63.  
  64.   It's unlikely a coincidence that hardly anybody uses the Trashcan drawer
  65. on the Amiga. Its use is anything but handy and here are some of the
  66. reasons:
  67.  
  68.   · Unlike the Mac, Amiga places the Trashcan drawer in the disk's root
  69.      directory window (it would be far better if it could be left out)
  70.   · A Trashcan is tied to the volume it is on: there must be a Trashcan for
  71.      each of the mounted volumes
  72.   · As a consequence, if you drag (e.g.) "Antani:Blinda/Patuo/Cuda" in the
  73.      "Work:" Trashcan, it will simply be copied to the "Work:Trashcan"
  74.      drawer, instead of being moved to "Antani:Trashcan/Cuda".
  75.   · If (e.g.) you need to empty the "Work:" Trashcan, you'll have to open
  76.      the root directory window of "Work:", click on "Trashcan" and then
  77.      select the menu item "Icons/Empty trash..."
  78.   · After all, many people have got used to live without the Trashcan,
  79.      simply by deleting the file(s)
  80.  
  81.   Have you got enough of it? Never mind: X-Trash is here (to stay!). If you
  82. would like to use the Trashcan without worries, this brilliant program will
  83. be the answer to all of your needs (at least that's what I hope).
  84.  
  85.  
  86. /* *\
  87. * 2 *   Usage
  88. \* */  ^^^^^^^
  89.  
  90.  
  91.  2.1. Requirements
  92. ^^^^^^^^^^^^^^^^^^^
  93.  
  94.   X-Trash has no special requirements: it needs 2.0+ OS and (if you want to
  95. choose from the requester the Trashcans to be emptied) reqtools.library V38+
  96. (by Nico François). Since it adds an AppIcon and four AppMenus to the WB, it
  97. also needs the Workbench to be running at launch [lunch? :)] time.
  98. As of v1.1, it also supports localization.
  99.  
  100.  2.2. Installation
  101. ^^^^^^^^^^^^^^^^^^^
  102.  
  103.   Pretty tricky, this. Just drag the icon wherever you want. That's all. In
  104. order to have the program running automatically upon every reboot, move the
  105. icon into the WBStartup drawer.
  106.   If reqtools.library V38+ is not installed in your LIBS: directory (have
  107. you just come back from Mars, pal?), you'd better get it as soon as you can.
  108. There's an evergrowing number of programs which require it, furthermore V38+
  109. gives you locale support. Try and install the fantastic RTPatch, too!
  110.  
  111.  2.3. Getting started
  112. ^^^^^^^^^^^^^^^^^^^^^^
  113.  
  114.   When run, X-Trash will show up a new, gaudy, icon in the main Workbench
  115. window. Drop the icons you want to get rid of on it: you can use multiple
  116. selection, if you want. It will also accept icons from different drawers/
  117. volumes. Icons will then be moved from their original place to the
  118. correspondent Trashcan.
  119. NOTEZ BIEN: At the moment it seems like there's no way to notify WB when a
  120. file without the .info file has been modified/moved/deleted. Therefore, WB
  121. won't update correctly such files (you can easily tell'em: they only appear
  122. if you selected the menu item "Windows/Show/All files"). Any bright ideas?
  123.  
  124.   Try and have a good look at the "Tools" menu. You should notice four new
  125. items.
  126.  
  127.   · "Empty all trashcans"
  128.      It will... empty all of the trashcans!
  129.  
  130.   · "Empty trashcans..."
  131.      If you've selected one/more volume icons, it'll empty the correspondent
  132.      Trashcan(s). It ONLY WORKS WITH VOLUME ICONS: directories or files just
  133.      won't do!
  134.      If you have selected no icons, it'll pop up a volume requester, which
  135.      will show you ONLY those volumes whose Trashcan is not empty. Choose
  136.      the volume whose Trashcan you want to empty. It will carry on asking
  137.      you volumes until you enter an empty string, close the window or select
  138.      the "Cancel" gadget.
  139.  
  140.   · "Empty trashcan..."
  141.      It's pretty similar to "Empty trashcans...".
  142.      If you've selected one or more icons, it will behave as above.
  143.      If you have selected no icons, it will pop up the requester just once.
  144.  
  145.   · "Empty multiple..."
  146.      Pretty useless this. It can be handy only with removable devices (e.g.
  147.      floppies). It will pop up the volume requester. Select a suitable
  148.      device: its Trashcan will be wiped. A requester will appear: insert one
  149.      by one the disks whose Trashcans you want to be emptied. Click on
  150.      "Cancel" when you're done with it.
  151.      It was urgently demanded by Michele "King of the Trash" Nappa, but one
  152.      day probably it will be pitilessly removed. Is it any good to you?
  153.  
  154.  
  155. NOTEZ BIEN 1: At the moment it seems like... etc... To put it in a nutshell:
  156. you have opened the "Work:Trashcan" drawer and "Windows/Show/All files" is
  157. selected. If you tell X-Trash to empty it, some of the icons may still be
  158. there, even if they've been successfully deleted. That's because those files
  159. don't have a real icon, which is simulated by WB by using a fake one. WB
  160. should be notified when an icon has to be modified/moved/deleted, but since
  161. there's no real one, there will be no notify: i.e., no update, the icon will
  162. stay there.
  163. Hint #1: try and use only files with real icons.
  164. Hint #2: select the Trashcan window and then the menu item "Windows/Update".
  165.      If you had opened any of the Trashcan subdirectories (provided they
  166.      exist), you could have to repeat the operation for each of them.
  167. Hint #3: Do not open Trashcan subdirectories. You're supposed to use X-Trash
  168.      because you're too lazy... Well, so be it!
  169.  
  170.  2.4. Kiss my ass goodbye
  171. ^^^^^^^^^^^^^^^^^^^^^^^^^^
  172.  
  173.   Double-click on the X-Trash icon (be it the AppIcon or the real one) and
  174. it will remove itself from memory.
  175.  
  176.  2.5. Tool Types
  177. ^^^^^^^^^^^^^^^^^
  178.  
  179.   Version 1.1 adds support for two Tool Types:
  180.  
  181.    · CONFIRM
  182.      If set to YES or ASK, X-Trash will ask you for a confirmation before
  183.       flushing a Trashcan. Defaults to NO.
  184.    · PROTECT
  185.      If set to ASK, X-Trash will ask you for a confirmation before resetting
  186.      delete-protection on a file/directory.
  187.      IF set to YES, it will always make sure the file/drawer is delete-able.
  188.      Defaults to NO.
  189.  
  190.  
  191. /* *\
  192. * 3 *   Odds and ends
  193. \* */  ^^^^^^^^^^^^^^^
  194.  
  195.  
  196.  3.1. X-Trash: the making
  197. ^^^^^^^^^^^^^^^^^^^^^^^^^^
  198.  
  199.   X-Trash was written using Amiga-E v2.1B by Wouter van Oortmerssen in June
  200. 94. I decided not to release it because it was SO much like AppTrash, but
  201. a friend of mine eventually convinced me, so *here it is*.
  202. I wrote the Assembly port but the source is strangely hiding itself some-
  203. where... as soon as I find it, I will release v1.1a (where 'a' means
  204. 'Assembly-coded'!).
  205. If you have translated the catalog file, please send it to me: it will be
  206. included in the next release!
  207. By the way, here's a $29.000.000.000.000.000 question...
  208.   Does anybody how to notify WB when a fake icon (i.e. which has no .info
  209.   file) has been modified? Help me!
  210.  
  211.  
  212.  3.2. Acknowledgements
  213. ^^^^^^^^^^^^^^^^^^^^^^^
  214.  
  215. I would like to thank...
  216.  
  217.  · Commodore-Amiga...
  218.  · Wouter van Oortmerssen...
  219.     Keep on improving Amiga E!
  220.  · Nico François...
  221.     You make the Amiga world go on...
  222.  · Michele Nappa...
  223.     Beta-testing, whatever that means to him (and me)
  224.  · Cinzia Montuori...
  225.     Unconscious bug-fixing suggestions! (she's NOT my girl/woman/wife!)
  226.  · Sting, D. Fagen, Queen, D. Bowie, G. & P. Conte, Yes, Bangles, INXS, Elio
  227.    e le storie tese, Dire Straits, Cure, D. Byrne, W.A. Mozart, B52's, Toto,
  228.    L. Dalla, The Who, J.M. Jarre, Fleetwood Mac, L. van Beethoven...
  229.  · D. Adams, M. Serra, K. Vonnegut, A. Rice, E. Queen, H. Hesse...
  230.  · Elaine...
  231.     Kimi wa kizi o kaita ka... tonikaku watasi wa kimi o ai suru!
  232.  
  233.   Their contribution has been invaluable to the development of this program!
  234.  
  235.  3.3. Future improvements
  236. ^^^^^^^^^^^^^^^^^^^^^^^^^^
  237.  
  238. "If it's a future world we fear
  239.  We have tomorrow's seeds right here
  240.  For you can hold them in your hand
  241.  Or let them fall into the sand"
  242.                  - Sting
  243.  
  244.   Any suggestions, as usual, would be very appreciated. Meanwhile *please*
  245. also check its stability and let me know about it...
  246.   Oh, yes, there are *3* other projects I'm currently working on: MOBS (Moon
  247. over Bourbon Street) and TITS (Tea in the Sahara), two less-than-useless
  248. programs; plus TxTools, a hyphenation-spellchecking-thesaurus library.
  249. Check'em out!
  250.  
  251.  
  252.  3.4. The author
  253. ^^^^^^^^^^^^^^^^^
  254.  
  255.   This program is FREEWARE. I don't ask anything, but if you like, you can
  256. send me PD programs, sources, postcards, money (why not?) or anything you
  257. can think of (I'd like to receive sweetmeats, anyway). I will return you the
  258. favour (do you like biscuits? Let me know!).
  259.   Here's my address... of course you can also send me suggestions, comments,
  260. questions, bug reports (Aaaaargh! God Forbid()!) and gossips!
  261.  
  262. SnailMail: Rudy Chiarito
  263.        Via Malpighi, 8
  264.        I-80014 Giugliano (NA)
  265.  
  266. Internet: chiarito@cli.di.unipi.it
  267.  
  268. (Ooops, I almost forgot: excuse me for my bad English!!!)
  269.  
  270.  
  271. /* *\
  272. * 4 *   Program history
  273. \* */  ^^^^^^^^^^^^^^^^^
  274.  
  275. ****************************************************************************
  276. *  v. 0.80ß [0.006] - 17/06/94                           *
  277. *  · AppIcon and AppMenus implemented. They do seem to work well.       *
  278. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  279. *  v. 0.90ß [0.014] - 18/06/94                           *
  280. *  · Now tries to show up X-Trash icon, instead of garbage default icon.   *
  281. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  282. *  v. 0.92ß [0.025] - 23/06/94                           *
  283. *  · Custom requester replaced by ReqTools by public acclaim (M. Nappa!).  *
  284. *  · Trashcan flushing now works fine.                       *
  285. *  · Bug in BPTR->CPTR conversion. Fixed. Thank you Cinzia!           *
  286. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  287. *  v. 0.99ß [0.047] - 25/06/94                           *
  288. *  · Added callback hook to volume requester. Now it shows up ONLY those   *
  289. *     volumes whose Trashcan is not empty.                   *
  290. *  · LOCKs and FIBs handling should work fine. Added tracking.           *
  291. *  · No longer tries to move objects already in Trashcan.           *
  292. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  293. *  v. 1.00  [1.000] - 27/06/94 - First public release!!!           *
  294. *  · Code cleanup.                               *
  295. *  · Support for locale.library halfly implemented.               *
  296. *  · Implemented "Empty multiple...". Urgently demanded by Michele Nappa.  *
  297. *  · Fancy icon (by Michele) added. Don't put the blame on me!           *
  298. * == - == - == - == - == - == - == - == - == - == - == - == - == - == - == *
  299. *  v. 1.10  [1.042] - 13/7/94 - First public update!!!               *
  300. *  · Didn't correctly search for program icon. Fixed.               *
  301. *  · Added CONFIRM and PROTECT Tool Types support.               *
  302. *  · Improved WB icon update upon deletion.                   *
  303. *  · Added locale.library support                       *
  304. *  · New icon design. Now you can put the blame on me...           *
  305. ****************************************************************************
  306. * akes it possible! Only Amiga makes it possible! Only Amiga makes it poss *
  307. ****************************************************************************
  308.  
  309.  
  310.        * · * · * · * · * · * · * · * · * · * · * · * · * · *
  311.  
  312.  
  313. "Per fortuna che c'è uno
  314.  Legge solo la Sacra Bibbia
  315.  Ore ed ore, notte e giorno
  316.  Ha un'indice d'ascolto fra i più bassi                · ***   · ***
  317.  Ma pazienza..."                       · * · * · * · *
  318.                               · *      · *  · *
  319.   - Giorgio Conte & Elio e le Storie Tese          · *     · * · **
  320.                                · *    · *    · *
  321. See you at the Restaurant at the End of the Universe!        · ****    · **
  322.